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PLATFORM-INDEPENDENT UNfTVFRS AL DATA ACCESS SYSTEM AND 
METHOD IN A CLIENT-SERVER ENVIRONMENT 



Background of the invention 

1. Field of the Invention 

This invention relates generally to client-server software systems and 
particularly to data access in a client-server environment. 

2. Description of the Related Art 

In the 1960*5 and 1970's computing was performed primarily by large 
mainframe computers servicing multiple users. Most users accessed the 
mainframe computer using a "dumb" terminal that had very little memory 
and computing power other than what was required to interface to the 
mainframe and to present data received from the mainframe computer to the 
user. In this scenario, each user was given time shared access to the 
computing cycles of the mainframe as well as to the programs and data stored 
centrally on the mainframe. 

With the development and proliferation of the personal computer in 
the 1980's another computing paradigm took hold. In this paradigm, a user 
worked on a dedicated "personal" computer and accessed a private set of 
application programs and data stored on the personal computer. Further, 
with this paradigm, no time sharing of processing cycles was necessary 
because the personal computer served the single user only. 

Another change in the computing paradigm was caused by the 
development of computer networking technology. Computer networking 
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technology links multiple computers to enable the transfer of data. The 
development of computer networking technology was particularly important 
in the corporate environment where sharing and exchanging information is 
of particular importance. One network architecture that has developed is the 
client-server architecture. In this architecture, one or more computers are 
configured as a "server." A server stores a set of shared resources such as data 
(generally organized by storage within the context of a database) and 
applications. Further in accordance with this architecture, one or more other 
computers are configured as clients to access the stored data and applications 
from one or more servers- 
Using this client-server architecture many companies have set up a 
system where various categories of corporate data are stored on various 
servers. In many cases, the client computers are based on different hardware 
platforms and run different operating systems. Further, in many cases, the 
server computers are just as varied in terms of hardware and operating 
system environments. For example, it is typical for a company to store 
human resources information in one type of database, inventory information 
in another, engineering documents and so on. Further, companies often 
need to access data stored in other types of data sources (storage vehicles) such 
as in an electronic mail system, or from a large mainframe data source. 

Accessing and/or updating data stored in these varied storage systems 
requires using a data management system tailored for accessing the particular 
type of stored data or directly invoking the application which stores the data 
(e.g. an email program, a word processor, the specific database and the like). 
Thus a user must learn separate interfaces for a variety of software 
applications in order to access, view and modify data from multiple sources. 
Additional system complexity is introduced when data access is desired from 
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a variety of computer platforms operating different operating system types. In 
these cases, conventional data access system and methods are ported for 
compatibility with more than one type of computer. 

Thus, there is a need for a system and method for accessing data that is 
stored in a variety of databases, in a variety of formats and on a variety of 
different types of computers. 

SUMMARY OF THE INVENTION 

In accordance with the present invention, a computer implemented 
system and method provides platform independent access to data stored in 
any one of a variety of data storage mediums such as SQL databases, 
mainframe databases, mass storage mediums, mediums accessible via a 
driver, electronic mail systems and the like. The invention includes a client 
module that provides a desktop operating environment having a desktop 
window operating "inside" a browser. The desktop window presents one or 
more books each representing data stored in a corresponding storage medium 
(e.g., on a particular server computer) and in one or more particular storage 
formats (e.g., in an SQL database format or in a particular electronic mail 
format). The books are represented by icons having a user-customized name. 
The invention also includes a server module in communication with 
multiple client modules. The server module includes a metadata for 
accessing data associated with each book. The server module further includes 
computer instructions that process data requests (access requests) received 
from the client module by (i) retrieving the metadata associated with the 
book, (ii) retrieving data corresponding to the metadata; and (iii) sending the 
retrieved data to the client module. 
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In accordance with the present invention, the client module is a 
browserware application. A browserware application is program code that is 
stored on a server and is accessed from and run within a browser running on 
a client computer. Advantageously, a browserware application (i) does not 
require user installation on the client side, (ii) is hardware and operating 
system independent on the client side and (iii) allocates a reduced amount of 
processing to the client computer thus reducing the use of memory and 
processing resources on the client computer. 

Further in accordance with the present invention, at a book provided 
by the client module is linked to (assocaited with) to data stored in a data 
source and to program code for viewing the stored data. Further, information 
stored in the server module's data object associates the name associated with 
the book with physical storage information (e.g., metadata) for retrieving the 
data. Data is then retrieved by processing the physical storage information to 
determine the location and format of the data being accessed. If the data 
resides in a database, then the location of the database is retrieved from the 
data object and an appropriate query is constructed then applied to the 
database. 

Still further in accordance with the present invention, the client 
module runs in a browser environment. The browser environment manages 
the interaction between the client module and the client computer operating 
system. The client module thus does not require installation on or 
configuration with the operating system of the client computer. Preferably 
the browser environment is a Java-compliant browser environment and the 
client module is a Java-applet. 

Yet further in accordance with the present invention, retrieved data is 
presented to a user in accordance with a viewing form and the system 
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additionally includes a scripting module for generating a customized viewing 
form. The scripting module includes a byte-code generator disposed to 
generate byte-code in accordance with user specified form layout. 
Advantageously, because the scripting module generates browser-compatible 
byte-code, the customized form displays data to the user from within the 
browser environment independent of the computer hardware platform or 
operating system on which the browser is running. 

Yet still further in accordance with the invention, the invention 
includes a user interface for configuring the server module for accessing data 
stored in any one of a plurality of storage mediums in any one of a plurality 
of storage formats. The user interface allows a user to specify physical storage 
information associated with data stored in one or more storage vehicles and 
stored in one or more data formats. The invention also includes a processing 
module in communication with the user interface. The processing module 
generates a data object using the information received from the user via the 
user interface. The data object associates the received physical storage 
information with a name (e.g. a data identifier). 

The features and advantages described in the specification are not all- 
inclusive, and particularly, many additional features and advantages will be 
apparent to one of ordinary skill in the art in view of the drawings, 
specification, and claims hereof. Moreover, it should be noted that the 
language used in the specification has been principally selected for readability 
and instructional purposes, and may not have been selected to delineate or 
circumscribe the inventive subject matter, resort to the claims being necessary 
to determine such inventive subject matter. 
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brief Description of the drawings 



Figure 1 is a functional block diagram of a data access system in 
accordance with the present invention. 

Figure 2 is a diagram of the data organization structure of a book 
provided by the data access system shown in Figure 1. 

Figure 3 is a flow diagram of object to relational mapping to access data 
in accordance with the data access system shown in Figure 1. 

Figure 4 illustrates a desktop window of the desktop client module 
shown in Figure 1. 

Figure 5 illustrates a new manager dialog window provided bv the data 
access system shown in Figure 1. 

Figures 6A-6C illustrate new book dialog windows provided by the data 
access system shown in Figure 1. 



The Figures depict a preferred embodiment of the present invention 
for purposes of illustration only. One skilled in the art will readily recognize 
from the following discussion that alternative embodiments of the structures 
and methods illustrated herein may be employed without departing from the 
principles of the invention described herein. 

Figure 1 is a functional block diagram of a data access system 100 in 
accordance with the present invention System 100 includes a client 
computer 101, a server computer 102 and data sources 108 coupled via a 
computer network 103. Client computer 101 runs a desktop client 105 that 
provides access to one or more of the data sources included in data sources 
108. Access is provided by a data service application 106 running on a server 
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computer 102. Data service application 106 processes data access requests 
received from desktop client 105 and returns the requested data for 
presentation to a user from desktop client 105. Desktop client 105 
advantageously runs within a browser 104, eliminating the need for 
customization and configuration of desktop client 105 to a particular 
hardware configuration or to a particular operating system type. 

Client computer 101 is a personal computer, a computer workstation of 
other computer type suitable for running browser 104. Browser 104 is 
preferably a conventional Java-enabled (Java-compliant) web browser such as 
Netscape Navigator 3.0 or Microsoft Explorer 3.0. A Java-enabled browser is a 
browser adapted to rim byte-code (written in the Java programming language) 
within the browser environment. The Java programming language is an 
object oriented programming language developed by Sun Microsystems and 
is defined in the Java Language Specification Version 1.0 by James Gosling, 
Bill Joy and Guy Steele (published by Addison-Wesley, August 1996) and in 
the Java Virtual Machine by Tim Lindholm and Frank Yellin (published by 
Addison-Wesley, September 1996), the contents of which are hereby 
incorporated by reference. In particular, browser 104 includes a Java Virtual 
Machine (JVM) that translates Java byte-code into object code for execution. It 
should be understood that although a preferred embodiment uses a Java- 
compliant browser, the principles of the present invention apply to uses of 
other browser types and uses with other types of byte-code virtual machines. 

Referring still to Figure 1, data access system 100 includes desktop client 
105 and an application programming interface (API) 123. Desktop client 105 is 
a "browserware application" that provides a user with access to one or more 
of the data sources coupled to server computer 102. A browserware 
application is program code that is stored on a server and is accessed from and 
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run within a browser running on a client computer. Advantageously, a 
browserware application (i) does not require user installation on the client 
side, (ii) is hardware and operating system independent on the client side and 
(iii) allocates a reduced amount of processing to the client computer thus 
reducing the use of memory and processing resources on the client computer. 

In a preferred embodiment, desktop client 105 is a set of Java- 
compatible byte-code instructions forming a Java applet that runs within a 
Java-compliant browser. Desktop client 105 is identified by a tag. The tag in 
turn is embedded in a world wide web (Web) page written in hypertext 
markup language (HTML). Desktop client 105 is accessed (e.g., downloaded to 
the client computer and run within the browser) when the tag contained a 
Web page is used to activate a link from within browser 104. 

When desktop client 105 is running, browser 104 manages the 
interaction between desktop client 105 and client computer 101 (e.g., browser 
104 provides an interface between desktop client 105 and client computer 101 
and its operating system). Desktop client 105 therefore runs "within" browser 

104 rather than interfacing directly with the operating system associated with 
client computer 101. The compatibility of desktop client 105 is therefore 
advantageously determined by compatibility with browser 104 rather than 
with the type of hardware or operating system associated with client 
computer 101. Further, desktop client 105 need not be configured to the 
particular hardware associated with client computer 101. Thus, desktop client 

105 is platform independent and can run the same set of instructions on a 
variety of computer hardware and operating systems, provided each is 
running a browser that includes a virtual machine that can execute the client 
desktop 105 byte-code. This platform and hardware independence eliminates 
the need for porting code to achieve multiplatform compatibility. Instead, a 
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single version of desktop client 105 will execute on any platform having a 
Java virtual machine. 

Server computer 102 is a computer configured to serve multiple client 
computers 101. For purposes of simplifying Figure 1, the detail of only a 
single client computer 101 is shown. Client computer 101 is coupled to server 
computer 102 using network 103. Network 103 is preferably an internal 
TCP/IP intranet although other networks uses such as the Internet or an 
extranet are used in accordance with the invention. 

Server computer 102 runs (executes) a data service application 106. 
Data service application 106 provides users at various client computers 101 
with access to one or more data sources included in data source set 108 Data 
service application 106 includes server side API 124, API proxy 125, forms 
module 126, view module 127, script module 128, replication module 129, 
security module 130, script compiler 131, data access module 132 
administration ("admin") tool 133, data source interface (DSI) 107 and JDBC 
110. 

Administration tool 133 is a program module that provides for system 
configuration and for the selection of data sources within data source set 108. 
Further, administration tool 133 allows a user such as a system administrator) 
to construct, for each selected data source, an access control list (ACL) 
specifying which users or user groups, are offered access to the particular data 
source. 

Server side API 124 is an application programming interface that 
processes information communicated to and from various desktop clients 
105. API 124 interfaces with API proxy 125. API proxy 125 is a program 
module that implements a remote method invocation (including object 
serialization) mechanism. The mechanism processes method calls received 
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from desktop client 105 for remote invocation. Remote invocation means 
that methods invoked at the client computer 101 side (e.g., by desktop client 
105) actually invoke methods on server computer 102 (e.g., on data service 
application 106). By remotely executing methods rather than downloading 
such methods to client computer 101 for execution on client computer 101, 
the use of client computer resources such as memory and processing power is 
conserved. API proxy 125 thus advantageously reduces use of resources of 
client computer 101. 

View module 127 is a program module that presents a user with a high 
level representation of data retrieved from a data source (e.g., a database 113). 
In one embodiment, data is presented in a row and column format where, in 
a design mode, the user selects which fields of a data source are displayed. 

Form module 126 is a program module that presents information 
associated with a selected row of data presented by view module 127. Selected 
information is shown in a customized form. Customized forms include 
widgets. Widgets are visual components such as buttons which, in 
conjunction with scripts cause the form to modify the presentation of data 
and perform presentation related processing. 

Script 128 is processing module that reads and executes or set of custom 
scripts (in byte-code) that are associated with the various widgets of a form or 
view. 

Script compiler 131 is a processing module that translates user- 
generated script text into byte-code. 

Replication module 129 is a processing module that provides 
functionality for mobile access of data. Replication module 129 copies 
information from a database, provides for its modification and copies it back 
into the database without performing an over-write. 
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Security module 130 is a processing module that manages security 
functions. Security module 130 encrypts data communicated between desktop 
client 105 and data service application 106. Security module 130 additionally 
manages user account and password information. 

Data access module 132 is a data access layer that manages information 
associated with views, forms, scripts, server names, user names, passwords 
and the like. Data access module 132 interfaces directly with data source 
interface (DSI) 132. Data access module 132 translates information between 
from the format used by API 124 and the format used by DSI 107. 

DSI 107 is a set of computer instructions that provide an interface 
between data service application 106 and data source set 108, 

Data source set 108 include structured query language (SQL) databases 
113, mail system 112, native database 121 and mass storage 134. Mail systems 
112 are conventional electronic mail systems including IMAP4 systems 115, 
POP3 systems 116, MAPI systems 117 and VIM systems 118. Native database 
121 is a database native to data access system 100. Native database 121 
provides an alternative data storage source and also stores administrative 
data used by data service application 106. Mass storage data source 134 is a 
storage device for information with large memory needs such as image and 
video data. SQL databases 113 are structured query language (SQL) databases, 
each accessed through a server computer 102. The various data sources 
included in data source set 108 can each reside on separate computers. It 
should be understood that the principles of the present invention apply with 
data sources residing on other computer configurations including where 
multiple data sources reside on a single computer. 

Data service application 106 additionally includes Java database 
connectivity module (JDBC) 110. JDBC 110 is a conventional application 
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programming interface for querying conventional SQL database available 
from Sun Microsystems. JDBC 110 provides capability to query databases 113 
to determine metadata including their connection status (e.g., whether a 
connection is established) and access, format and syntax information not 
specifically defined by the SQL. 

Figure 2 is a diagram of the data organization structure of a book 200 in 
accordance with the data access system 100. Book 200 is named personal 
contacts and provides access to information associated with personal contacts 
stored in a database. Book 200 includes a database identifier 201, a table 
identifier array 202, a join condition 203, and a plurality of views 204. 
Database identifier 201 stores information identifying a particular database on 
a particular server computer. Database identifier 201 is used to construct an 
address to communicate with the database corresponding to the database 
identifier. Table identifier 201 is an array of table identifiers that specifies one 
or more tables in the database. Join condition 203 specifies a particular join 
function to be used to combine the tables listed by table identifier 201. Views 
204 each specify a custom view of the joined data. View 204 includes a search 
condition 205, a selection (list) of attributes 206, and a plurality of forms 207. 
Search condition 205 is the equivalent of a where clause in an SQL statement 
Selection of attributes is a list of attributes (fields) to be presented in the view. 
View 204 provides information that is used by service application 106 to 
construct a request for a database search result. Service application 106 
processes the request, queries the selected database and returns the result set 
in a dynamically created object 

Figure 3 is a diagram of a dynamically created result set 300. Result set 
300 includes a set of result objects 301. Result objects 301 are each person 
objects including a set of attributes 302 (fields) associated with data 
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corresponding to the person. Attributes 302 includes, for example, start date, 
fax number, cell number, work number and home number. Each person 
object 301 is generated as a result of a database query constructed using a JDBC 
SQL call 303. The JDBC call 303 performs a table join of the person table 304 
and the phone number table 305 associated with the database identified by 
book 300. The table join is perform using the person LD. as the sole join 
column. Each returned person object is presented within a view as a row. 
Further customization and refinement of view data is performed using forms 
207. Forms 207 enable selective viewing of data within each view based on 
column characteristics. 

In operation, data access system 100 is preferably first configured by a 
system administrator for access by multiple users. These multiple users are 
each preferably identified by user identifications (LD^) and by passwords. 
Users are preferably organized into "groups" based on characteristics tailored 
to a particular organization's need. For example, a company might arrange 
users into the following groups: engineers, sales staff, marketing, finance, test 
and production. The same company might additionally define a different set 
of user groups such as: part-time employees and full-time employees. 

During configuration, a system administrator selects data sources from 
data source set 108 and for each selected data source, generates an access 
control list (ACL) identifying which users or user group are given access to 
the particular data source. Administration tool 133 includes the program 
instructions that effect such system configuration. Further description of 
administrative configuration is described in the Admin and DataSource ACL 
Manager sections of the user's manual included in this specification. 

Once data access system 100 is configured as described above, then 
system 100 provides users with access to selected data sources from desktop 
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clients 105. On start up, a desktop client 105 is downloaded to a client 
computer 101 and service application 106 performs an initialization process in 
accordance with the system configuration. During the initialization process, 
service application 106 polls (using JDBC 110 for queuing database sources) 
each data source in system 100 to determine whether a current connection can 
be established. Provided that a current connection is established, service 
application 106 queries each connected data source to determine access syntax 
and format. Service application 106 thus generates and stores metadata for 
retrieving data stored in the connected data sources. 

After startup processing, desktop client 105 is copied from (downloaded 
from) server computer 102 to client computer 101 for execution. The copying 
and execution of desktop client 105 is initiated from within browser 104. 
Upon execution, desktop client 105 presents the user with a desktop window. 
Figure 4 illustrates a desktop window 400 in accordance with the present 
invention. The desktop window 400 presents a user with the option to select 
a set of books 402 that are available to the user. A book is representative of an 
information link to one of the data sources in data source set 108 and the 
applications used to process such data. Because desktop window 400 is 
provided by desktop client 105 running within browser 104, the data source 
set 108 is advantageously accessed without dependence on the hardware 
platform and operating system included in client computer 101. 

Desktop window 400 provides access to the data associated with each 
book 402 (e.g., enables the viewing of data associated with the book). Access is 
controlled by disabling selected items in a dropdown menu 404 that appears 
when a user selects a book 402. Selecting the open command from dropdown 
menu 404 causes a view manager dialog window 500 as shown in Figure 5 to 
be presented. View manager dialog window 500 is a dialog box that displays a 
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list of available views 501 for a corresponding book 402. Selecting a particular 
view 501 causes data associated with the corresponding book 402 to be 
displayed in accordance with the format associated with the selected view 501. 
Desktop window 400 also includes a status bar that presents operational and 
status messages along the bottom of desktop window 400. 

Books are added and deleted by user or system administrators using 
interfaces presented from desktop client 105. To add (create) a new book, a 
user selects a "New" command under "Books", This selection causes a new 
book properties window, 600 as shown in Figure 6A to appear. The new book 
properties window 600 includes a services box 601 that enables a user to select 
the service (e.g., the server) that contains the data source that the user wants 
to associate with the book. After a service is selected, the desktop client 105 
next presents an updated new properties window 602 as shown in Figure 6B. 
The updated new properties window 602 replaces services box 601 with a 
datasource box 603. Data source box 603 includes the name of dates sources 
(e.g., JDBC, MAPI, POP3, Native etc.) that are available from the selected 



After selecting one of the presented data sources, desktop client 105 
presents a set of dialog boxes that enable a user to further specify information 
for accessing the corresponding data source. For example, if a JDBC data 
source is selected, the user is presented with a dialog box such as the further 
updated new book properties window 605 shown in Figure 6C Further 
updated window 605 includes a new box 606 titled "driver". The further 
updated window 605 provides a list of JDBC drives corresponding to 
configured JDBC drivers for selection. After selecting a driver, desktop client 
105 presents either dialog boxes enabling a uses to select a database by name 
and a table within the selected database. 



service. 
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If a user selects an electronic mail data source rather than a JDBC source 
from updated new properties window 602, desktop client 105 presents a user 
with a sequence of dialog boxes allowing the user to select the desired mail 
profile and its location. 

Alternatively, books are added to a desktop window 200 by importing 
them from a server 102. To import a book, a users uses a set of dialog boxes to 
select a server computer 102 and to the select a book on that server. 

The following user's manual is illustrative of and further describes 
system and method of the present invention: 
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Songa Pages: Version 1.0 




Pages Desktop CBent - As an implementation of browser/server computing, 
the Pages Desktop client Is an applet that gives Java-enabled browsers a window 
into Sanga Pages applications. 

Pages Desktop Server - The core of Sanga Pages, it allows clients to access 
"books of information* which represent links to data sources and the applications 
required to leverage that data. 

• Access controlled by user ID/password 

• "Boole" metaphor for retrieving, storing and viewing Sanga Forms and Views 

• Network tools for remote access to personal customized Desktop Client 
through internet and access to databases on other servers 

• Administrative tools for adefing users and groups, broadcasting messages, 
and more 

Pages Form Design - Gives developers a set of GUI design components to 
create sophisticated front-ends for custom applications or templates for data 
viewing. Standard GUI controls include static text boxes, buttons, text fields, 
scro&ng text, check boxes, radial buttons, pull down ists, and regutar fists. All 
controls have selectable cola, fonts and scripts. Also includes variable granularity 
grids for alignment, group alignment ana resizing, includes standard reusable 
scripts. 

Pages Script - This robust, BASJC-Ite compiled programming language enables 
developers to add functionality to forms and create more detailed custom 
app li cations. Together withPages View Design and Pages Form Design this 
completes the package of ptatfor^^ 

tools. Scripting options include declaring variables of different types, executing 
common looping and COTditlonai expressions, create extensions Into the Sanga 
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Pages API library, otsptaying message bans, perforrriirig field cxxess ana vaiiao- 
tton. inserting, updating deleting data ctototiase navigation (next. last, p^ 
etc.) syntax chectang and error reporting. 

Pages Security - Administrators can create access control lists and use DES 
enay^rtsostoni Developers can also use wrappers that support Northern 

Sl^ro^^^ 81 ^ 86 ^- ^9° Poses Security can encrypt 
an data tiai 4* r ytled to and from Sanaa Pages clients and SQL databases. provide 
usef-tevel security, field level securtfy and support olgttai signatures. 

Pages Mall - This supports and integrates aft major protocols (including POP3/ 
SMTP. MAPI and IMAP4) with attachment support. 

P ag es Bepi c<^on - Sanaa Pages allows users to copy databases across 

p^onmforefftoentdistebuted^ 

copies of the same database. 

Pages View Design . Sanaa provides a tleirfce query tool that enables users to 
create custom ad hoc views of data. This too) is perfect far managing targe 
f^fy^o/ <**o and lew >geiiU4 JsoBfit oiuirJM«)swa ii it u MiuJM l ficfflS^ 
databum tight from wnntn their browser. Operancb supported ^ctude<,> <> = 
and . or. »e. Users can specify which database fields to view and adfcfitlhe 
order, noma and column width of those fields. 
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Introduction 




Tr^rronuai introduce you to Sot rt contains al! the informa- 

tion and instructions you need to use FtagesOesWop Client. Ftr^esSefvef. Pages 
View Design tages Form Design, Beiges Script, and Pages Security. 

TWs manual assumes you are famaar wttheWwr Netscape Navtgator 2.0 (or 

betteflhtaosoftMero^ 

r ^^,w J .jj ff Ol running Javoupptets. 



The tottow^ list <xjtfines the chapter 

Tntroducflcxi\ which you aiecu^ 
features of Sanga Pages. 

"Starting tages Desktop and 
reviews the components of the Poges Desktop window 

Ttages Desktop esrmxra' describes in detaflfreujir u iiuiKjsawlableintages 
Desktop. 

■Boges tfew Design* describes in detai how to create and ectto view of a Plages 
Book. 



Chapter Descriptions 
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•Pages Form Design' describes m aetaii how to create ana eart a form usea to 
examine me fields of a Pages Book. 

*Pages Script" describes in detail the syntax of the ftages Script language. 
TogesSecurrty'expksnsttrese^ 

"Pages Server" desctibes in detail the features and toots avatabietoanaamrnistTo- 
tor of Sanga Pages. 

Manual Conventions 

This manual uses certain corwenttoro. includlrig 

the manual Itself, teytooard conventions tor using SangoPar^ 

ogy describing mouse techniques. 

Common Actions 

This manual uses the foOowing terms to mean specific actions: 
Select 

Select means you Indicate an item by cficttngorceontherteintom 
highBght to the Item. For example! 

• you select one option button from a group of option buttons: 

• you select an rrem in a drop-down box; 

• you select a We name in a dialog box; or 

• you select a check box. 
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Choose 



Choose means you carry out on action. This means aouble-cticfcng on an nem 
or pressing ENTER once the item is selected. Choosing an item causes something 
to happen immediately. For example: 

* you choose a command from a menu; 

* you choose a command button in a dialog box 

* you choose OK in a dialog Pax to activate any changes you have made; or 

* you choose CANCEL to close a cfialog box without mating any changes. 



Typographical Conventions 

This manual uses various typefaces, inducing; 
SMALL CAPS 

Entnes in smal caps represent specific keys on the keyboard that you press. 
Graphic symbols or abbreviations may label these keys. 

Monospaced 

Monospaced type indicates a command that you type, 
tfatfc 

Italic type means you replace the text In Italics with your own text 
(square brackets) 

ftems in souoie brackets aie options fri commands 
Bold 

Mereis o l o c ltow . co m m an d s , and controtocndkJog boxes use boid type 



Mouse Techniques 

A <m a t*o word teim identifies comrnoty in this manual, these 

terms are used to ovoid l e p e aihig detailed descriptions of the action. These 
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4 introduction 



Terms ar©- 

• poimmearo you move the nK>use pointer cri^ 
the commana or item you want to select. 

• elide refers to the action of pressing and leteasfrrg the mouse button aiicWy. 
The rnsnuction to click something means you use the left button on me 
mouse, wntie ngnt-ctictc means you must use the right button. 

• douOte-cticJc means you press the left mouse button twice while on the 
indicated object 

• drag means you press and hold the mouse button white movingthe 
mouse. 
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Starting Pages Desktop Client 



This chapter Irtroducesyou to Pages Desktop Cfient. tt describes how to start ana 
exit the <vpficatm and reviews the co^ 

For the purposes of this manual, tages Desktop Cfientwi be referred to as Pages 

f> n iiliin m 

uesnop 

To stctf Pages Desktop^ open your preferred Ja^ 

Netscape Navigator, Microsoft internet Exptoreietceieia)<VKlcaO up the Pa^ 
Desktop site. The Poges logon window wffl appear asking you tor you user id 
password, and desktop service. Enterbothyouuser /dandpassvvordand select 
the desktop service you wish to use Horn me dropdown list (the default value is to 
use the local service). Select OK to continue. It you do not wish to log on at this 
*"*Mtwn either close your web browser or open a new location to end me logon 
session. 




If you select OK and the user Id and paaward are void me Pages Desktop 
irtndowwl appear m ihedefaJt setting developed by your Sanga Rages adrrtnfc- 
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& -raffing Pages ~ ^:^> Qtertt 

Pages Desktop Window 




Pages Desktop uses a tabular tay<^ 
This discuss^ assumes a starxtadir^^ 

The mam portion of me Rages Desktop is the tabbed panel used to organize the 
books at a Pages user, rnmoJVtherewfflbecmtabwttr^ 

The Button Bar appearing down the left side erf tf« widow show the ^ 
selections available. Under Tabs*. New, Rename, and Mete appear. Under 
"Books', the buttons cated New. Import and Arrange appear. Save and 
About are the last two buttons. 

The Status Bar, which gives you operational and status message* appears at^ 
the bottom of the Pages Desktop window. 
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Quick Start 




This chapter gets you started using Pages Desktop for some baste taste. inctixJing 
viewtog data in forms and entering data into forms. These tnstnjctions provtae you 
wtmtheabffltytogetupartfrunrtir^ 

M of the Instructions in Quick Start assume that you adn ft uUiu t o r has already set 
up yaur desktop, provided you with Pages Boote you can import and you are able 
to Log onto to your toges Desktop, tf you ore setting up your own desktop 
please refer to the chapter entitled "Pages Desktop Commands'. 



This wl show you how to quicfcy import a Rages Book to get miking right amy 

l. On themcJn Pages Desktop select the Import button under the "Books - 
heading. Ihbwibrtng up the import books dttog window. 



Importing a Pages Book 
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2. from me aropdown list tfsefvefsl 

you togged onto (unless your cun tu H sn a t o r has placed the default boons 
in another location). A Iter of the Pages Booksavariable for import appears 
in the selection list. 




3. Select a book you wish to import from the list and cOck on the OK button. 
The dialog window should dteappear and the selected tab in the Rages 
Desktop should now contain the tages Book you just imported. 



View the data in the Pages Book 

With the Pages Book you lust imported, you should be able to use the Views and 
Forms to inspect the data* To view the dato in a Pages View: 

1. Click on the Rages Book to bring up its dropdown menu. 
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2. Select the Open... item. This wiO t*mg up the View Manager ac»og wmaow 
whteh wtl display a m of available Poges Views. 



Rf- C 




3. Select the View you wish to use from the fist and cfidc the Open button. This 
wttbrtngupaViewwirxJowcxyTtafr^ 




To view the data in a Roges Form: 

1. Cfick on the Pages Book to bring up tts dropdown menu 

2. Select the New:.. Item. INswi bring up the Farm Manager didtogwtnaow 
which win display a fist of avaiable Pages Focms. 
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riuick start 



3. Select the Form you wish to use from the ttsr ana click the Open button. This 
will bring up a torn winaow containing cata from an entiy in the ftoges 



Book. 




Field Help 



WhenyouDtaceyourajrsoronat^ 

the workspace arc wiflirKteate the fu*c^ For example; if vou 

place your cusor on the New button underoam^c^ you wti see the message 
"Create new wakspace* beneath the current workspace. 



Creating a New Tab 



1. m the Pages Desktop window, cfick on the New button under Tabs'. A 
window w3 appear called "New fab". 




2. m the text bax Mowing Desktop 
the tab. 



Name, enter the name ^xj want to cafi 
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Quick Stl. 11 



Select the OK button to save the cnosen tab name or Cancel to return to 
the ftOQes Desktop window. 



4. 



If you select OK. a new tab wffl appear in the Pages Desktop winaow wrth the 
name you have chosen. 



Renaming a Tab 

1. in the Pages Desktop window, select the tab vouwi^ to rename by cticWng 
on the tab name. The acton wifl move the tab to the front of the other tabs. 

2. Click on the Rename button under Tab. A new window wffl appear catted 
"Rename Tab". 




3. tn the text box tottowing New Desktop Nome, enter the new tab name. 

4. Select the OK button to save the new tab name or Cancel to return to the 

5. If you select OK, the original tab wi appear with the new name you have 
chosen. 



Deleting a Tab 



1. m the Paget Desktop wmdw* select the lob yog wfeh to delete by cteMna on 
the tab name. This action wB move Ihe tab to the trant of the other tabs. 
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2. CDck on t he Del ete button unoer ToDs A new window will aopear cattea 
•Delete Confirmation'. The message in the wtnoow is *Are you sure you want 
to delete this tabr 



3. If vou select the No button, the request for deletion wft be canceled ana you 
wl return to the Rages Desktop window. 

4. If you select the Y*s button, the tab selected wtt be deleted, including the 
books within the tab. 



1. In the Rages Desktop window, select New under *8ooks*. 

2. A new window will appear entmed TYew Book Properties". In the 'Services' 
boot select the service that contains me data source you want ft* Fbges 
Book to reference Bherdoubtodck on the selected service name or select 
Open from the bottom of the window. 




Creating a 



New Book 
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A new oox wi retaoce the 'Services* box caned Toges Data Source", in me 
box are came names of the data sources (i.e.: JDBC. MAPI. POP3. Natrvei 
available to you from me servra you Select the aata source 

you wish to use for your Book. Then select Open. 




Depending upon the type of aata source you selected, the remaining dialogs 
w*aWer as follows: 

JDBC 

a) Anolhernewboxwiiepiace a fog«Dc^ 

Selecf the JDBC drfcer (these wW correspond to the configured ODBC 
drivers) you wish to use tor your Bex* an^ 
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b| A new window appears called "Connect tnfonncmonV in tne text oox 
foUowmg User ID", enter your user id and then select OK. 




c) A new window appears reauesttng your password. Enter your password 
in me text box and then select OK. 



dj The next message in me >Jew Book Proper^ 

Name * Select your chosen database and then dtefc on Open. 




e) A new message appears in the New Book Property 

for the Table Name - . Select the table name you wish this book to 
represent and then select Open. 
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MAPI 



o) Another new box will replace "Boges Data Source* called "Profile 
Name". Select the mai profile you wish to use for your Book another 
select Open. 



a) A new window oppeagcaOed ^Connect tnforma Hon* , in the text box 
following *MaM(POP3) Server, enterthe address ot the server otk> then 
select OK. 




b) A new window appecn reouesttng the location of your SMTP Server. 
Enter this i nfo rmation in the text box and then select OK. 




POP3 
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c) Anewwrnaowapoeofsraauesft^ tn the text do* 

following User Name*, enter your user id tor me mob server and men 
select OK. 




d) A new window appeals leauesttng your password. Enter your password 
in the text Dox ana then select OK. 



r-i r 




Native 

a) Ancmer new bCKwfflieptace , Tto9es Data 

Select the native database you wish to use for your Book and then 
select Open. 
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5. A new wtnaow appears cattea •Book Name*. Enter a name for your dook. 
select an icon to represent the book ana then ctick OK. 



6. The newPoges Book icon labeled with the name you have cnosenwffl appear 
in the current workspace in Rages Desktop. 



This feature allows you to Import an easting Rages Book into your Desktops The 
book you wish to import can east either on your local service or any other avad- 
able service in the network, 

1. Select the Import button under -Books, 

2. A new wtidow appears cufcxj*frnport Books". Select a server (Pages Server) 
torn the dropdown box tolowlng^ 




3 ' ^J***?^ 

underneath the Server prompt 

4. Select the book you wish to tniport to v^ Clck OK to import the 

book and return to your main desktop window. The imported book Icon will 
appear in your current workspace. 




Importing a Book 
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5. Select Cancel to return to the mom desktop wmaow without importing me 
tXX*. 



Save 

It you select the Save button, you wfii save the format of your desktop as welt as 
all the books and forms you have created. It Is suggested tnatvou save vour 
aeswop periodically during ihe time you use ittoprevemiosirtg the forms and 
views. 



About 



If you select the About button infoirnato 

number will be displayed in a window. C9ck on the OK button to dismiss the 
window. 




Working With a Book 



16 work with a Pages Boot cfldtance on the book's Icon. A drop-down menu wfll 
appeal with the following chores: 



Open 

TNs option alow* you to open a previously created Pages View of the book. 
1 . Select Open... trom the Books dropdown menu. 
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2. A new wmaowapoears carted •View Manager. This wtfl present a qst of 
available Pages Views tor me boo*. 




3. To select a view either type the name in the text box following me View 
Name' prompt or select o view from trie est. 

4. Cttck on the Open button to continue or Cancel to return to the main 
Pages Desktop window. 

5. if you selected Open a new window appears entitled Vew • WewAtame*, 
where VfewAJbrm matches the one selected In step 3. Ybu cannot edit this 
view but you can use the Query tool on the date. The Query tool aDows you 
to fitter the data of the view by applying o set of selection aneria. With the 
tool you can filter on a sfrigie database field or a combination of up to four. 
There are three ok* i mi its to each solo c tton criteria. 

a) Database Column * this is a 1st of at columns in me database 

b) Comparison- the tods for comparison are equate {=), not equals (<>) 
less than (<). greater than (>) and fke (UKE). 

c) Vblue-this is the value to compare against. 

For example one seloctton criterion oppsY wl to onErnptoyoo d< Jlttt m j&w may 
be: YearsOf Service > 5. This would return a view of an employee 
records In the database wrJh a value in the YfcxssOrService column greater 
than five. 
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The selection criteria can be joinea with erther AND or OR. if AND jans two 
selection criteria then both must return true ftx the record to be disotoyea in me 
view. Using OR in the fitter fist means that a record which matches any of the 
selection criteria wW be nctuded in the view. 



Trite optton allows you to open a pre\tou^ 
entries in a Rages Book. 

1. Select New... from the Books dropdown menu. 

2. A new window appears cased "Form Manager. This wffl present a fist of 
avertable Rages Forms Tor the book. 




3. to setectafomn either type the nameta 
Name* prompt or select a form from the Mtf. 

4. CJtt on the Open button to continue or 
Desktop window 




6. Close the window to return to the main tages Desktop window. 



New 
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5. If you selected Open a new w»K3ow appears entmea "Pages Form*. You 
caruwe<jtthekjvoutofthi$ form snouia oaow 

you interaction wrtn me data. 



Design:View$... 

This option allows you to create, edit, and delete views of the Rages Boot 

1. Select Design and then Views... from the dropdown menu. Thfe wtil bung up 
the "View Manager" window used for waiting with Pages Views. 

For further i n for m ation on accessing the functiono^ol the* View Manager 
window, please refer to the chapter entttledTages view Design*. 

Design:Forms... 

This option allows you to create, edit and delete toaro of the Pages Book ele- 
ments. 

1 . Select Design and then Forms... from the dropdown menu This will brtig 
up the "Form Manager* window used for working wantages Forms 

For further information on accessing the functiondty of the Pages Form Design 
please see that chapter. 

Rename 

This option aOows you to rename the Book. 

1. Soioct Rename from the drop-down menu. 
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2. A newwinaow entitled "Rename Book* appears, tn the text box foiiosMrig me 
message New book name, type in the new name for this cook. 




3. It you are satisfied with your new name, cttck OK to return to the mam menu. 
Ybu will see that the new name of the book has replaced the otd name unaer 
the Icon. 

4. if you decide not to rename the boot cfick the Cancel button to return to 
the main drop-down menu. 



This option is not part of Sanga Rages Vbcsion 1.0 

Replicate 

This option is not part of Sanga Pages version 1 .0 

Delete 

Thfc option atoms you to delete the selected Pages Book. 

1. Select Delete from the dropdown menu. 

2. A confirmation screen wTO appear askir^ 
remove the sotoctod buukT 

3 - Sete cMtes to confirm ihe deletion and the Pages Book wM be renx>ved from 
the Desktop. 

4. Select No to cancel the deletion of the book. 



Copy 
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lcon:Stick and lcon:UnStick 

These options allow you to share and/Of move Pages Books between tnetaosot 
the Desktop. 

1. To share o Pages Book among the tabs of your Desktop, simpty select Icon 
and then Stick from the book's cropaown menu. Now it you move among 
the various tabs of your Oesktopyou wtl see book is visible to afl of them 

2. ff you want to move a Pages Book from one tab to another begm by 
foflowmg the some procedure m step 1 . Now move to the tab where vou * 
wish to move the book to and select Icon ana men Unstick from the book's 
dropaown menu. Nowtr^booklsonryvis^orrthattab. 



PropertiesrShow 

"This option shows vou afl the Book's properties 0.edcta source driver, user name, 
etcetera) 

1. Select Properties and then Show torn the book's dropdown menu. 

2. A new window appears cafled Ttook Properties*. This window contains intor 
motion about the book you have opened irxkxjhg the iiame and the Pages 
Data Source. Other information displayed depends on the type of Rages 
Data Source the book is United ta 




3. Select OK or Cancel to return to the main Pages Desktop window. 



PropertiesrACLs... 

This option alows you to create an Access Control Ust [ACL) tor you Pages Book. 
Creating an ACL w* ensue ttxiton^ authorized users can import 
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1 . Select Properties ana then ACU... from the Dock's aropaown menu. A 
new winaow appears catted •Book ACL Properties' . 



2. The Name of the book is displayed at the top. This value cannot be changed 
as it must match the Pages Book name. 

3. Below this are two lists: a User List and a Grou> Ust. The User List contains all 
local users managed by this service. The Group List contains the default 
system wide groups as well as any tocaly defined groups. 

4. Next to these istsae the Pages Psfmlssions which are made up of fte 
following set (ControL React Update, ExeciJta Test for Existence Detete. 
Creole). Whenever© user or group is selected these check boxes wil reflect 
the permission set for that user/group. To odd (box c on t ains a or remove 
(bat is empty) a peirrtssion simply clck on toe appropriate field and the value 
wilbetoggted. 

5. Select OK or Cancel to close this window and return to the Pages Desktop 
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Pages View Design 




Creating a View 



1. Select Design and then Views... from the Book's dropdown menu. 

2. A new wtnaow appeals cated , \tew Manager". 

3. Enter the name of the view you wish to aeateinthetextbaxfolowingthe 
prompt tor View Name. 

4. Oleic on the Create button. Two new windows, simttar to those shown below 
[N^ewdesignKbrnpandviewtootsI .bmp], appear entttied "Mew Toob* and 
View Design -vievtf^rne*, wherevte»ftiarne&then^^ 

5. In the "V/tew Tools* wMow, select a f^ 
from the Column Hst 

6. The Name of the field wi appear In the text box following Label: ^ the 
Properties box You can change the label of the cotumn in the view by 
deleting the default name tor label and then entering one of your choice. 

7. To display the selected field in the view you osb creating, select the Display 
tn view check box. You wi notice that there is anew column in the View 
Design* window whose title marches the label of step 6. 

6. Conarwto so l p c lrW storthe 

Each field that is added when the Pttptay In view check boot soiociou wi 
appear m the "View Design* window. Once you rvjwe select aft the fiett 
noo d o d for your view, you may now test the view design. 
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9. When cooing fietas to tne view, The Mode menu on me View Design' 
wndow should have tavout selected* To test accessing arxadisoiaving 
information m your view, select the test option unaer the Mode menu on the 
'view Design* window, testing the view wt) display the if ormction ot the 
columns you have selected from me oook. 



10. To save the current view design ot any time, select Saw under the File 
menu to save the design under If s current name. Select Save As... under 
the Re menu to Wng up the •Save As../ dialog wiridow which will alow you 
to save the design wtth a different name or overwrite an easting view design. 

11. 16 exit the m Vlew Design* window at any time, select Close Editing from the 
Foe menu on the "View Design" window 



1. Select Design and then Views... from the Book's dropdown menu. 

2. A new window appears called ''View Manager". 

3. Select the view that you wish to etft Ihe view name wfl) appear in the text 
box tottowtng the view Name p r om p t. 

4. Click on the EOt button. Two new windows appear enWIed'Vlew Tools' and 
"View Design -tfewNan^ wheievia^^ 



5. m the "View footer window, select the field that you wish to edtt in the viw 
from the Column list. 




Editing a View 



step 3. 
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6. The name of me fleid wtfl appear in the text box following label in me Prooer 
ties cox, You can edit me label of the column by aetetcng the current laoei 
name ana then entering a new name for the column . 

7. To change the field cfcotav of the view, select or de-seiect me Dismay in 
View check bax, depending on the selected field. You wi notice the ftetd 
and lobe* changes happening concunentv ^ the View Design* winaow. 

8. Continue to edit the view you are assigning tallowing steps 5 to 7. Once 
you have finished editing me columns in your view, return to the View Design* 



9. When editing fields in the view, the Mode menu on the View Design* window 
should have layout selected. To test accessing and displaying irtf ormarion m 
your view, select the Test option under me Mode menu on the View Design" 
window. 

10. To save the current view design at any firm 

menu to save the design under It's current name. Select Save As... under 
the FBe menu to bring up the *Save As..." dialog window whi(*wifl allow you 
tosovethedesignwtmacOTeremnaTOorcv 

11. To exit the View Design* window at any time, select Close Editing from me 
FHe menu on the View Design* window. 



1 . Select Design and then Views*., from the Boole's dropdown menu. 

2. A new window appears cased view Manager*. 

3. Select the *ew that you wish to delete. The view name wifl appear in the text 
Pox folowing the View Name: prompt 

4. Otek an the Delete button. A new windoww» appear coned 'DeteteConfir 
motion*. The message in the window is "Are you sure you want to delete the 

BQIOCTOa n&TnT 

5. If you select either the No or Cancel button, the request to deletion wll be 
canceled. 

6. If you select the Yes buttoa the selected vtowwl be deleted. 



window. 



Deleting a View 
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7. After confirming me ae*etton you w» return to me "View Manager wtnaow 
wnere vou can select Cancel to close me window. 
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Pages Form Design 



Creating Forms 

1 . Select Design and then Forms... from the Book Icon's dropdown menu. 

2. A new window appearscafled form Manager'. 

3. Enter the name of the form you wish to create in me text box following the 
prompt for Form Nome. 

4. Click on the Create button. Two new windows, simitar to those shown below, 
appear entitled "Properties* and Tarn Design*. 



17 
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3u zgestorrr ? 

5. in the 'Form Design' winoow you con aeore several different types of ooteas 
in your form: 



Creating a Text Label in Form Design 

1 . tn the "Form Design' wtnaow, click on the Create text label button, or 
select Label from the tools menu. 

2. In the "Form Design* window again, elide and drag to create an appropriate- 
sized text. The text box can be resized at any time Dy selecting a resize tat) on 
the text box and dredging it to the desired size. 

3. By default the word fexfwBiappew m the tabel box you haveaeared. 

4. Select the General tab of the •Properties" window. The default values of the 
text label win appear; the W for the text label wffl be TabehT.Ladel wai 
contain the actual text fey the label with the default of Text, and Field will be 
lnoneJ\ 

5. To change the kj of the text label srn ply enter a different ID instead of the 
defeat value fottowing the "Poor label in the "Propertie s * window. 

6. To change the text fctside the label, skT^ry replace fexf in the text box 
folowing the prompt for Label tn the ^Properties* window. 




7. lo adjust the font site and style of the test In the text label defc on the Font 
tab in the "Properties" window. 
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8 . In the Font tat), select your chosen font from the aroDaown ttst following me 
Font prompt, 

9. Enter your selected font sae in the text be* following Font Size. Youatso 
nave the option of making your font in the text laoei box bold ana/or italic 
by selecting the appropriate check boxes. 

10. To adjust the color of the text and me bockgrouna ot me text box. setect me 
Color tab in the "Properties* winaow. 

1 1. To change the color of the text select me Foreground raaio button. Then 
point and cUck your cursor on the selected color in the cotor box. YtxiwiU 
notice that the text in the 'Form Design' windows text label writ change to me 
selected color. 

12. To change the color of the to setect the Back 
ground radio button in the Color tab. Then point and click your cursor on 
yourcnosen colorin the color bax. YajvvfllrKJtiCTthattt^bcckgo^ 
text label in the Torm Design - window wffl ctwge to the selected color. 



Creating a Button 

1. In the Form Design window, cflck on either the Create button totf button, or 
Button from the Tools dropdown menu. 

2. Click and c^ to create on appropriated 
window. A thre» dim e n sionci button wffl appear with the default tobei of 



3. in me •Properties* window, select the General tab. The default values of the 
button wi appear; Id wi be *button#*, label wi» be Button, and the Script 
button wi reveal itself to be empty. 

4. To change fhe Id of the Button, stTTplyen^ 
rather than the defend! value. 

5. To change the label of the burton from the ctefautt setting of simply 
enter the new button label m the text box following the prompt for Label. 

6. To odd the script whJcftwierttbte 

either select a database unity routine from the dropdown fist or cick on the 
Script button. 



Button. 
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7. A new wroow aoDeors catted *Scnpt - nur, Enter the scnpt coae wnicn 
enabiesthe button to oertoimrtsaes^octkDntnthefoff'n. Rememoerro 
enter a carriage return after eachfine. Please refer to the chapter on Pages 
Script for details on programming in Scnpt 



9. To adjust the font type and sMe of the text in the Button, dck on the Font 
tad in the "Properties* wcidow. 

10. Vbu can change the font of the button usrig the dropdown box to choose a 
font. 

11. ThefontsgBisautorTK^atyset^ You have the 
options of making the button label bold and/Or Matte by selecting the 
appropriate check box. 



Unite text boxes* you cannot change the color of the text of the button label or 
the button itself. 



Creating Single-Line Text 

1. tn the Term Design* window, cflck on either the Create 4ngto-tine text 
tool button or lext Held from the Tools dropdown menu. 

2. in the *Form Design* window again, dek and drag to create an appropriate- 



8. 




Note: 
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3. Select the General tab of the 'Properties* wmaow. The aetoutt values of tne 
text box wi appear; ta wfli be *textfieia#* and Reld wilt be ^nooel*. 

4 . To change the Id of the text oax, simply enter a different id instead of the 
default value. 

5. Select the field of the book to be displayed in the text pax by cnoasing one 
from the Reld dropdown list. 



7. To adjust the font size and style of the text m the text box. click on the Font 
tab in the -Properties* window. 

8. In the Font tab, select your chosen font from the dropdown 1st following the 
Font prompt 

9. Enter you sotoctod font ste In the text box following Font Sto, You also 
have the options of making you font in the text box bold and/or Italic by 
selecting the appropriate check boxes. 

ia To adjust the color of the text and the backgRaund of the text box. select the 
Color tab in the Properties' window, 

11. To change the color of the text select the Foreground radto button. Then 
point and click you curaor on the selected color in the color box. 

12 To change the color of the background of the text label select the Bade 
ground radio button in the Color tab. Then point and cfick your cursor on 
your chosen color in the color box Ybuwffl notice that the background of the 
text box In the Torm Design* window wB change to the selected cotot 



6. 
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Creating a Scrollable Text Area 

1. in the "Form Design' window, ctidc an either the Create scrollable text 
area tool burton or text Area from the foots aropaown menu. 

2. in the 'Form Design* window again, click and drag to create an oooroDnate- 
stzeascrottabte text area, in general these areas will be toiler men the angte- 



line text areas so as to display several lines of text at once. 

3. Select the General tab of the "Properties" window. The default values of the 
tract area will appear; Id wiD be *textArea#* and Field wfli be Inonef . 

4. To change meld of the text area simpryer^ 
default value. 

5. To select a field from the book fa the text arm 
dropdown list following Held. 



7. foadgusttaefontsteandslytoofthetert^ 
tab in the "Properties" window. 

8. Select your chosen fom from th^ 

9. Enter your selected font size in the text bax following Font Ste. You atoo 
have the option of making you fait In me text box bold cn^drMlc by 
sotoclU iy the appropriate checkboxes. 

10. Tb adjust the color of the text and the background of the text box. selec* it* 
Color tab in the "Properties" window. 



6. 
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1 1 . To change the color of the text select the Foreground racno Dutton Then 
pom* and click your cursor on the selected color inthecoiorbox. 

12. To change the color of the background of the scrottaate text area select the 
Background radio button in the Color tab. Then oomt ana ctck your cursor 
on your chosen color in the color box. Ybuvtfl notice that the backgrouna of 
the scrollable text area tn the form Design' window will change to the 
setectea color. 



Creating a Checkbox 

1 . In the "Form Design" window, ctick on either the Create checkbox tool 
button or Checkbox from the Tools dropdown menu 

2. In the form Design" window again, dick and atog to create an appropnate- 
siz^d checkbox. 

3. Select me General tab of me "Properties" The defoutt values of the 
text baxw* appear; Id will be *checkflox#". the Label wi be Checkbox, 
and Script win be empty. 

4. To char^ the Id of the checkbox s^ 
default value. 

5. To crwige me label of me checktm replace 
and enter one of your choice. 

6. To add me script whtehwi enable the checkbox to pettorm its aesiieda^ 
either select a aatabCM utfMy loutin^ 

Script button. 

7. A r*ew window appears catted •Script -nur. Enter the script cadewhich 
enc*» the chectoax to perform ted ftememt 
to enter a carnage return after each One. Please refer to the chapter on 
RogesSciipl for details on progicnvning in Script 

6. To adjust me font sae arid style of the labet of tr^ 
ForttabintheTroperttes"wtndow, 

9. Select your chosen font from the arapa^ 
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10. Enter your selected font size en the text box fol)owrg Font Size. You aso 
nave me options of making the font of the cneckbax kadei bold ana/or 
Italic by selecting the appropriate check paxes. 

11 . You cannot adjust the color of the checkbox 



Creating a Radio Button 

1 . tn the "Form Design" window, click on either the Create radio button tool 
button or Radio Button from the Tools aropoown menu 

2. In the form Design* window again, ciick and drag to create an appropriate- 
sized rado button including a text label. 

3. Select the General tab of the "Pr o perties* window, The default values of the 
radio button wfQ appear Id wllbe *radtoButton#*. the label wtu be Radio 
Burton, the Group wffl be empty, and Scrtpt wtt be empty. 

4. To change the Id of the racfio button, simply enter a cflfferent ID instead of 
the default value. 

5. To change the usbel of the radio buttoa replace th^ 
label and enter one of your choice. 

6. For any buttons In the same group, at mast one of the buttons wfl be active 
at one time. When a button is selected, the previously selected button is de- 
selected, ft is feoufred tor several radio buttons 

nx>stor>e of the buttons can be active at one t^ 

added to groups. In the Group section you must define the group this racfio 

button belongs to. 

7. To add the script which win enable the rodto button to perform Its desfred 
action, either select a dattxsse utfBly routine from the dropdown 1st or dick 
on the Script button. 

8. A new window appeamcafled "Script -nuT. Enter the script code which 
enables the radio button to pe r rut i n Its d os fc p d action In the form. Remember 
to enter a carriage return after each fine. Ploaso refer to the chapter on 
Rages Script for details on programming In Script. 

9. To adlust the fort s&e and style erf the 
Font tab in the Properties" window. 
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10. Select your cnosen font from me arooaown m foaowtng me Font oromct. 

11. Enter your selected font size in the text dgx following Font Size. Youatso 
have the options of making you font in me text box bold ana/or italic by 
selecting me appropriate cneck boxes. 



vt>u cannot adjust the cotor of a radio button. 



Creating a Dropdown List 

1 . In the "Form Design' window, cfick on either the Create dropdown list tool 
button or Choice from the Tools dropdown menu. 

2. tn the ParmDesk^ window again, cfick and drag to create an appropnate- 
sized box for a dropdown fist. 

3. Select the General tab of the 'fropefties* window. The default values of me 
dropaown list will appear. Id win be -choice**' and the Script witt be empty. 

4. To change the Id of the dropdown 1st sffnply enter a cfifferentD instead af 
the detail value. 

5. To add the script which will enable the dropdown list to perform its desired 
action, click on the Script button. 

6. A new window appears cafled "Script -nuff\ Enter the script code which 
enables me dropdown 1st to pertoim its desired action in the form. Remem 
ber to enter a carrtoge return after each fine. Please refer to the chapter on 
Pages Script for detcis on programming in Script. 

7. To a<$usf the font size and style of the text In the dr^^ 
Font tab in the Properties" window 

8. Select your chosen font ftom the dropdown fist folowing the Font prompt. 

9. Enter your selected font size in the text box fdlowtng Font Sto. Yauato 
have the options of making your font m the text box bold anchor italic by 
sotoc l ing theappcoptlotecrieclcbowBS. 

ia To adjust the artor of the text and the bock^^ 
Color tab in the Properties* window 



Note: 
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11. To change me color ot me text, select me Foreground raato button. Then 
point ana click your cursor on me selected color *\ me color oca. 

12. To change me color of the background of the texf label, select the Back 
ground radio button in me Color tad. Then pornt and click your cursor on 
your chosen cote - me color oax. You will notice mat me oackgrouna of me 
aropaown list in me "Form Design* window will change to the seiecrea color. 



Creating a Scrollable List 

1. in me "form Design* window, click on either the Creole scrollable list tool 
button or List from the Tools dropdown menu. 

2. in the Form Design window agora cbek and drag to create an appropriate- 
sized scrollable list box. 

3. Select the General tab of me "Properties" window The default values of me 
scrollable list w» appear td wfll be form# # and Scrtpt win be empty. 

4. To change the Id of me scrotoble 1st slnpty enter a differed 
the default value. 

5. To add me scrtpt which wfll enable the scroiable Hst to perform its desired 
action, click on the Script button. 

6. A new window appears coded "Script - nuT. Enter the scrfet code which 
enables the ftt to perform Its desired action in the form. Remember to enter 
a carriage return after each Brie. Please refer to the chapter on Pages Script 
for detais on programming in Script. 

7. To adjust the font size and style of the text displayed in the scrollable tet box. 
dick on the Fort tab in the 'PropertiesT window. 

8. Select your chosen font for the text In the scroficble 1st from the dropdown kst 
following me Font prompt. 

9. Enter you selected font stein the text box following Font Stee. You also 
have the options of making your font In the tert box bold and/or italic by 
ielocring the appropriate check boxes. 

10. To ad|ust the color of the text and the background of the scroiable list box. 
select the Color tab In the "Properties* window. 
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1 1 . To change the color of the text select the Foreground radio Dutton. Then 
point end click your cursor on the selected cotor tfi the cotor box. 

12 To change the cotor of the background of the scrollable list bone select me 
Background radio button tn me Cotor tab. Then point ana click your cursor 
on you chosen color in the color box. \bu wtt notice that me backgrouna of 
the scrollable list box in the •Form Design' wtnaow will change to me seieaea 
cotor. 



1 . Select Design and then Forms... from the Book icon's dropdown menu. 

2. A new window wi appear caQed •Form Manager*. A fist of possible Aoges 
Forms to select from <*e in the list under me prompt for Form Name. 

3. CQck on the form you wish to edit. The name of the form you have c hosen 
wtt appear in the text box f otowing Form Names. 

4. Select Edit if you wish to use Rages Form Design to edrt your selected form 

5. Two new windows w« appear catted Ttopem Edit the 
Form using the same ejection s as the section on Xteating a New Form". 



1. Select Design and then Forms... from the Book's dropdown menu. 

2. Anewwindowappearscaled'Form Manager*. 

3. Select the form that ycxj wish to delete. The view name wifl appear 71 the text 
box following the Form Nome prompt. 

4. C8ck on the Delete button. A new window witt appear called ''Delete 
Conflrmotlprr. The message in the window is "Are you sure you want to delete 
the selected itemT 

5. rf you select either the No or Cancel button, the request tor d ota ti on wtf be 
canceled. 



Editing Forms 



Deleting a Form 
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6. \t you select me Yes button mesetecreoform wtHbeoefeted. 

7. After confiirnrng me deletion you will return to the "Form Manager winoow 
where you can select Cancel to close me window. 
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Pages Script 




As described previously, Pages Script is a Basic-Jte compiled programming 
language which enoD^ createa 
inSanga Pages. Not just for straight-forward data access, Pages Script can be 
used for form routing, data triggers, vctfdation, process automation, and many 
other advanced programming applications. Pages Script wffl be famiar to 
developers who era experienced wtth general scripting languages. Furthermore, 
this chapter is designed for those readers who have some experience wtth writing 
shed scripts. 



Vbriable - a variable is a named storage kxxition that hoWsdctfa that changes; 
every variable can hold onty one kind of data 

Before you can use a variable In Pages Script, you must request that the variable 
be created by declaring the variable first To declare a variable means to give 
the name and data type of the variable. Once you have declared a variable, it 
always retains its original data type. A Pages Script program has no Hmlt on the 
number of variables it declares. 



Using Variables 



Pages Script Data Types 



integer 



Numeric values with no decimalpoint or fraction, Integer values 
range from -32. 768 to 3Z 767. 
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string Doto tnat consists of 0 to 2E+38 characters of alphanumeric 

aata. Alphanumenc means that the acta canoe com aiono 
betic arad numeric. String data values may atso contains soecioi 
characters such as ~ %@. 

dim Statements - aefine variables, dim - short for "dimension" - * a Pages Scror 
statement that you wrtte in an application's Script wrnaow. 

Using dim, you tea Rages Script; that vou haw a variable what to name the 
variable, ana what kind of variatte you v^.Atways use a dim statement to 
define variables oefore you use variables. 

Format of the dim Statement dim VQrName as Datatype 

VfcrName is a name that you supply, vwen Pages Script executes the dim 
statement at runtime, it creates a variable in memory and assigns It the name 
yougrveintitevdrNametocatkx^ 

Datatype is one of the two Pages Script dctto types defined in the above table. 

For example, the tottow^ . 
dim ftoducfTatai &s integer 

From the dim statement, you know that the variable holds integer data and that 
its name is ProductTotaL 

AO Pages Script corre i tunds and buit^ioutinesareocBelnsensrirve. Although you 
donotrxivetonameyourvartableswr^ 

pt o gr ami i w dofeythesafceotOTre is t e r^ Addtttan al c up s help dbttngush 

irK<Mducri wa d su is i deanaTO 

name of a variable). 

Nate: Never define two variables w«h the samename Boges Script wont know 
which one you are referring to when you try to use one of them 

Shortcutl - When you need to define several variables: 

msteod of Qsting each variable derlnrtionc^separato ^esfikelhis: 
dim A as integer 
dim C as integer 
dim D as siring 
dim £ as siring 

You can combine variables of the same data type on one taa For example: 
dim A C as integer 
dim £>,£ as string 
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Assigning Values to Variables 

null string - a zero-Jength empty string mat is often represented as * " . 



(Mining Variables 
Rag^ Script initiated 

string variables. Use the "assignment statement" wnen you want to put other aata 
values into vanattes. 

FGimarf of the as^gnment statement: vb/rVo/ne = Exprsssion 

The VfanVame is a vartawe that vou have defined u^g tne oimstoternerA 
£*prasstoccribeacoratam ano^ 

fcoample: Suppose you need to store a rnirtmum age value of 18 in an integer 
variable named MtnAge The tolowing assignment statement doesthat: 
MrnAge= 18 



Mathematical Expressions 

Operator - a word or symbol that performs data manipuiatton and/or comparison. 

Math Operators 

Tabte of Wnroy Math Operators 



Operator 


Example 


Description 


+ 


Net* Bsc. 


Adds two values 




Price -4.00 


Subtracts one value 
from another 


* 


Total* Fact 


Mutt|ptet«o values 


/ 


TcrfAdiust 


OMdes one value by 
another 
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How to Use Mathematical Operators 

Suppose mot you wanted to store me difference between 

istored fri a variable named AmuatSaies) and the cost of soles {stereo in a vanaoie 

named CostOfSates) in a vanotAe named NetSafes. Assuming mat at! three 

variables have oeenaefineaarua initialize 

computes the correct value tor NetSodes: 

NetSates = AnnualSales - CostOfSates 

This assignment leUs Pages Script to compute the value of the expression and to 
store the result in the variable named NetSates. 

No matter irow complex tt^ result 
beforeit stores tnatresult in tt^ variables to left of the eauate sign, in the 
foQowing assignment statement, for example, is rather lengthy, but Pages Script 
computes the resutt and stores the value In o variable reamed Celsius; 

These two fines convert a temperature of 30° Fahrenheit to the correct tempero- 
ture in Celsius 

Fahrenheit » 30 

Celsius = (R3hrenheM2) *9/5 

Combining expression often produces urrinterided results because fages Script 
computes mathematical results in a predetermined order. Pages Script then 
computes afl muMpttcation and dMsion (working from left to right • before any 
addition and subtraction). 

For example: 

Pages Script assigns 1 3 to Resutt In the foiowlng assignment: 
Resu» = 3 + 5*2 

it is possible to ovtwikfe the o^MCitor precedence by using parenthesis* Pages 
Script always computes the vetoes inside any pair ot parentheses before anything 
etse in the expression, ovon If it means ignoiu ig opmator precedence. 



Relational Operators 

Relatione) Operators compare data values to one another. They test conditions 
that are erther true cx fate. And thus the^ in 
other words, one data value is either more than another (a true resutt) or the data 
value Is not more than the olher (a false result). 
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The Relational Operators 



Operator Usage Description 



> 


Sales > Goal 


The greater than ooerator 
Returns true if the value on the 
left side of > isnumencottyor 
atpnabeticatly greater than the 
value on the right. Otherwise, 
false. 


< 


Pay < 2000.00 


The less than operator. Returns 
true if the value on the left side 
of < is numerical or atphabeti 
caBy less than the right. Other 
wise, false. 


= 


Age = Limit 


The equal to operator (some 
times called the equal operator). 
Returns true if the values on oath 
sides of * are equal to each 
othet Otherwise, falsa 




FirstName >« Tvflce* 


The greater than or equal to 
operator. Returns true if the 
value on the left side of >= is 
numerical* or atphabetloaty 
greater than or equal to the 
value on the right Otherwise, 
false. 


< = 


Num< » WAmtCaplton 


The less than or equal to opera 
ton Returns true if the value on 
the left side of < « is numericc&y 
oratphabeticctylessthanor 
equal to the value on the right 
Otherwise* false. 


<> 


txtAns.Text <> *Yer 


The not equal to operator. 
Returns true (f the value on the 

left side of <> is numerically or 
atptabettcafty unequal fa the 
value on the right Otherwise^ 
false. 
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lb understand how relational operators work, you must unaersrana now to use rneir 
true or false results. The If statement introduced tfi me next section explains now 
you can use true and false results to mote decisions in your program. 



Keep Each Side a Consistent Data Type 

The expressions on both sides of a relational operator must have the same aato 
type or at least compatible data types, tn other worm you cannot compare a 
stnng to a numeric data type, if you try youwtt get a Type mismatch error 
because me data types don't match. 



Program Flow Statements 

Ite all other proyiarnming languages, tages Script supports bom conditional 
statements and loops to dtrfwrftdne the program flow* Prior to discussing me now 
control structures we should mention Blocks. Stocks consist of one or more Pages 
Script statements. The block of statements found in o control structure are 
bounded by me start of the structure and th^ statement. For example, 

an if statement completes with an end if statement or a do while loop ends with 
a (oop statement The Pages Script language supports nesting of these piugruin 
flow structures. 



Conditional Statements 



The if... then... else Statement 

The if statement uses relational opeialors to test dato vatues. It performs one of 
two possible code actions* dependng on the result of the test. With it state- 
ments. Pages Script tests whether to execute blocks of code. The If statement 
mokes decisions, if a relational test is true, the bod/ of the if statement ex- 
ecutes. 

One format of if: 

if retaflona/fesf then 
Block 

end if 
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The end if statement informs Pages Scnpr where me ooav of me it sraremenT 
enas. Forexampie; 

if state = "New York" -her. 
TaxRate - .0775 

end if 

if state = "Massachusetts" cher. 
TaxRate = .06 

end if 

The body of the if executes on*/ if the relational test is true. Otherwise, me rest of 
the p ogr o m continues as usual. 

A Shortcut Form of If called the Single-Line Format : if retattonaflest then 
PSStctement. 

This format does not reauire an end if statement because the relational test and 
body of the if are aD in one line. 



Handling False Conditions 

The eise stateme n t executes code based on the relational test's false condition. 

Theetostcten>enlispa!tcJcnextenc^tfsta^ 

that executes if the relational test is false. 

Format of If Statement with else'. 

if retottonaifest then 
flee* 

else 

Stock 

end if 
Forexampie: 

i f (BankBatance < 0) then 

Me &so geBcx pOrardrawn*) 

else 

MessogeSax rtnCredtT) 

end if 

fftheaxidtrionparikflc^ 
then fri Credit is deployed. 
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Loop Statements 

Loops ore usea when me same set of steos nave to be camea out many times. 



The do white... loop 

The do while statement performs flow control based on a relational expressions 
just as me if statement aoes. The relational expression controls me toopmg 
statements rather than a single block of code. Many lines of your program will still 
execute sequential but a loop will cause blocks of coae to repeat zero, one or 
manytimes, 



Format of the do while... loop; 

Do while (relational text) 
Block 

Loop 

The block of code continues looping as long as the relational test is tiue. You can 
put as many lines of cocte in tiro btock as tonga 

changes a variable used in the refcrtonattest The block of code will keep repeat- 
ing as long as the do whNe loop's relational test continues to stay true. Eventually, 
the fetatkxtoi test fTUJSt become forise - otherwise you wV encounter on infinite loop. 

An example of the use of the do whle... loop: 

answer =~ 

Do while answer otsT&fit answer <>"Y* 
Answer « toUpperfrnputfioxTOo vou want to delete this record?")) 
loop 



The for... loop 

Tr^ for k)op is sometimes aaled the - to Unice the do loops, the fa 

loop repeats tof a specified number of times. A for loop always begins with the 
for Statement and ends wtth the next statement 

Format of the for... loop: 

for CounferVtr * StarMji to EncMal (step tncrerrtentaMaf) 

fltoc* 
next CounferMa/ 
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TheioopinmefoJlcwrgettrnptecc^ l to 1C. 

Sum = 0 

for Number « 1 to JO 

Sum = Sum + Number 
r.exc Number 



The Exit For Statement 

Sometimes. ycx/D be processing user input or several dato values usmg loapmg 
statements, and an exception occur In the acta tnar reauires and immediate 
termination of the loop. For example, you may be collecting sales vaiuestora 
company's lQsdestfvtSKra^ However, 
the user can enter 2ero tor a division's sates voiue. indicating that mere ts no sales 
data for that drvWon. Rather than complete the loop, your program might need 
topultthelocpatthcfrpx^bea^^ cant be 

gathered at the time. 

The exit tor statement outomattcoay terminates the loop. No matter how many 
iteratiom oe teft in the for kx>p. whBn Poo^ 
rtieru Rages Script Immeota^ 
atultff nent foflowing the loop. 

Typfccly,on if statement tr^g^c^c^tt^e x ttstolen^r^ tomis: 

for Orvtstons« 1 tolO 

Bkxk //Code to get a sates vatue 

if (sales = 0) then 

exit for // QUH the loop earty 

end if 

Bkxk 
next DMstons 

The if ensures that the exit for executes otiryunderoiiespecillccono3fion(o 
missing sates value), Wthout that specific cx^^ 
cycles norma*. TheexttforccrtstructcancjnVte 
is a way of leaving the loop immecflotety. 
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Utility Functions 

There are about 70 utifity functions that ore bulft into Sanga Scoot These provrae 
useful snortcuts ana functionality to the Script user. 

To use these functions you must type the name in exactty as snown beiow al- 
though the functions are case insensitive. These functions can be broken up into . 
about 5 different groups Database. Screen, Math. String, Other 



Screen Functions 

The Screen functions manipulate the different things you see on the 
screen. 



Me$sogeBax(msg) returns void. 

where msg is the message you wish to tisplay. 

This function puts a box up on the screen with the contents of msg inside. The 
script wUl then WATT FOR A MOU& CUCK before proceeding. The argument msg 
may be a string or a number. 



ContlnTiMessogeBox(msg) returns an Integer. 

where msg is the message you wish to display. 

This function puts a box up on the screen with the contents of msg inside. Adcft- 
tionally. there wfll be two buttom with YES and NO inside the box The user must 
click on one for the script to proceed. The function w» return a 1 if the user clicks 
on YES and 0 it the user cttcked on NO. 



ScreenReidfrld) returns String 

where fid is the legitimate ff> of an object on the screen. 

This function returns the contents of the fid object if the fid objoct is a fist or o 
choice, it wi return the chosen element tf there ts no answer, the function will 
return an empty string. 
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setSoeenF^fia newvdlue) returns void 

wnere fid is me legrtlmare ID of an object on the screen, 
where newAtaiue « what value you wish fla to take on. 

This function sets me contents of me ftd object to the contents of the newvaiue 
variable. To setmetetorcnotceoofec^ you must use setUstBeme^ 



hideFieldlfld). showfieW(fW) bom return void 

where fid is me legitimate ©of an object on the screen. 

These affect me reouested object on the screen. The hideFietd function matces 
the requested object invisible ana cnsabtea. The user cannot see nor act on me 
screen object The showField function manes the obiect visible ana enablea. 



(JbuUoTloldtfld). enctoieFieidfrld) bom return void 

where ftd is the legitimate ID of on object on the screen. 

These affect the reouested object on the screen. The cfcabtefieid function 
mates me requested object gray and dead. The user cannot act upon the 
screen object. The enabteFteWfuncto redraws t 



0uUU5uf(fld), fleldlsResettfld) bom fetum frit 

where fid is the legitimate ff> af an object on the screen. 

These are on V to be used on checkboxes and radio buttons. These two screen 
element types can be Inl of 2 states, ether they are ON or OFF. It the re- 
quested screen object Is ON. then the function returns 1 , if the requested screen 
object Is OFF, then the function returns 0. 



setf ieWtfld). resetFie*d(tld), tog^efiek^fld) an return void 

where fid is the legitimate ID of an object on the screen. 

These are only to be used on checkboxes and radio buttons. These two screen 
element types can be in 1 of 2 states. Either they are on or off. The setField turns 
the requested object ON. The resetFiekj tuns the reouested object OFF. The 
toggis fl eti object changes the state from ON to OFF or OFF to ON as the case 
requires. An object thcrtte pat of a group may r^ Ybu must turn 

ON a dfflerent object in that group. 
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cteartisttflcl) reruns void 

wnerefld is the legitimate ID of an object on the screen. 

This function is onfy to be usea on a choice or tet screen object This function 
totes afl the elements or selections off of the aesirea object 



addUstEntryfflel entry). removeUstEntrvtfkl entry) returns void 

where fid is me legitimate ID of an object on the screen. 

where entry is the String representation of the element to be affected 

These functions are onty to be toed on a choice or fist screen object. The 
. addUstEntry function puts the String variable entry onto the end of the choice or 
list object. This new entry may now be chosen bythe user. The removeUstEntry 
takes the specified entry off the list. 



senvruntptejoocTionsnKj return voc 

where fid is the legitimate ID of an object on the screen. 

These functions should onry be used on o list scroon object. A fist screen object 
may be used to make mufflple selection Vbu must first tea the tot 

object to work in thrs manner. A fist scroo n object wftonJyafiow one se l e ction by 
default CottngthesetMuttlptoiSoloctton function with the fid orgument as the 
screen ID wll make the list screen object aflow multiple selections. Calling the 
resetMurripto Selection function wflh the fid argument as the screen ID wll make 
the list screen object not oOow multiple selections. 



getNumbeiSelectedfftd) returns int 

wheietld is the legitimate ID of an object on the screen. 

This turction shoutd ontybe used on a ttst This function wi return 

the number of entries the user has selected. This rumber may be onywh oro from 
0 to the total number of entries on the 1st 



geweiecDorqna, seiecnortr\ftjmoerj returns vrr 

where tld is the legitimate ID of an object on the screen, 
where sotoctionNuoibfif tells vrf^ich soloction you wWi returned 

IMstuncflon should onty be used on o8st screen object Once you know the 
number of selections the user has chosen via the getNumbecSelecred cat), this 
function can be used to get each indMduai selection. If there are more than 
one entries selected, then you must make multiple cofis to this function. 
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Database functions 



DataBasefteloffld) ietums String 

wnere fid is the legitimate 10 of a field in the database. 

This function returns the contents of me field in the current recora of the aatODase. 
if the© is no sucnfie*a anocurervrec»athenthefurc 



setDataBaseFieJdffld, newVatue) returns void 

where fid is the legitimate ID of an object on the screen, 
wnerenevtf/olueiswholvatueyo^ on. 

The function sets the contents of the fieid in the current record of the database to 
the contents of the newNttue variable, if there is no such field, then the function 
wts do nothing. 



update!) returns void 

This function copies the contents of the screen to the database to be saved . 



detete() returns void 

TNs taction wu remove ttrocw 



oddnewf) returns void 

This function wBJ get a Wank record ready to be added to the database. Vbu 
trust fotow this co3 vWth ^ 
function to the database. 



movensxtfl returns void 

This function changes the current record of the doiabo» by moving the record 

after the current record. At) screen fieio^wiaautoniam^CV be chan 

this. 
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moveorev() returns voia 

This (unction changes the current record of the database Dy moving the recora 
before the current record . All screen fields will automatically be cnangea to 

reflect this. 



moveflrstfl returns void 

This function changes the current record of the database by moving the record to 
the very first recora. AH screen fields win automatically be cnangea to reflect the. 



movetast() returns void 

This function changes the aarent record of tt^dcrtabase by moving the record to 
the very end record. All screw fields wittautomaficatty be changed to reflectthis. 



movetofrecNumber) returns void 

where recNumber is the number of the new record you wish to 



This function changes the cunent record of the database by awing the record to 
the desired position in the database wtiich is specWW by the recNun^ variable. 
All screw fields will automatically be changed to reflect this. 



getcunecnumj) returns int 

This function returns a number which represents your position* This 
number wffl always be positive unless you are in the midst of adding a new record 
to the database. 



String Functions 

sUtuf \[stt) returns int 

This function returns a count of the number of characters in the variattestr. 



goto 
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ngnttsrt counr) returns String 

This function returns a new string which is identical to the count ri gh tmost charac- 
ters of the variable str. 

teftfstr, count) returns String 

This function returns a new string which is identical to the count leftmost characters 
of the variable str. 

midsti(str, start count) returns String 

This function returns a new string which is identical to the count characters starring 
at the start character of the variable str. 

concattstrl . str2) returns String 

This function returns a new string which is identical to with str2 added on to tne eno 
ofstrl. 

nto&(nurnber) returns String 

This function returns a new strir^tftich is the representor 



stor^sri) returns integer 

This function returns a number 



sbcrrtpfstrl . str2) returns Integer 

This function returns a number which is compiled by comparing Itie siring in str] 
with the siring in str2. tfstrT is the same as s!i2. the taction returns oO. tfstrl is 
ctfphabetlcoiryeartierttmstt^ Otherwise, the 

function reruns a 1. 



form. 
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smcmp(sti count) returns SlrinQ 

This function is the some as strcmo aoove. wrth the exceotion mar an uopercase 
letter is considerea to be eaual to the same lowercase letter. 



toupperjstr), totowertstr) return String 

This function returns a new string which is created Dy taking the argument and 
converting any lowercase characters to uppercase. Or uppercase to lower for the 
totower function. 



trim(str) returns String 

This function returra a news 
removing any leading or iraing spaces. 



chatAtfirr, position) returns String 

This function returns an Integer representor the character at a sp^ 
the string. 

indexofchrtsti character) returns In tu y m 

This function computes and returns the position in the string of the ch^ 
argument. If the character is NOT in the string, then the function returns-! . 



indexofstrjstrl , searchString) returns Integer 

This function computes and returns the position In the string of the second string 
argument. If the search siring is NOT In the string, then the function returns-!. 



nexrindexofchrtstr, charoctet srort^osrUon) returns Integer 

This function is Identical to the indexof chr function with the exception that the 
uxjctring does not start wtth the first character but Instead wO start s&uivl w i^ at a 
position in the third argument 
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nexftnaexofctijstr, character) returns integer 

This function is identical to me inaexofstr function with the exception mat me 
searching does not start with the first character Out insteaa will start searching at c 
position m the third argument 



abstnumber) returns Rooting Point Number 

This function co mp utes the absolute value of the argument. That is. it maxes the 
number positive if It Is not already so, and men returns ft. 

cefi(number) returns integer Number 

This function computes and returns the smallest whote number mat is larger than 
me argument. 

ftoorfnumber) returns Integer 

This function computes and returns me largest wftfe number tn^ 
the argument. 

log(number) returns Rooting Point Number 

The function computes and returns the natural log of the argument. 

sorftnumoer) returns Rooting Point Number 

This function computes and returns the square root of the argument 

pow(number, power) returns Rooting Point Number 

Thb function computes and returns the result of the first number raised to the 
power of the second number. 



Math Functions 
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matjnumoerl , numoer2) returns Rooting tan? Numoer 

This function computes ana returns the forger of ihe two arguments. 

rTrin|numberl , numoer2) returns Floating Bornt Numoer 

This function comoutes ana returns the smaller of the two arguments. 

Miscellaneous Functions 

copytoscreenf void) return void 

This function copies ai database fields into their corresponding fields on the 
screen. 

copvtobookfvoid) return void 

This function copies afl screen fields into their corresponding fields in the database, 
getdatefvoid) return String 

This function computes the current date ond returns if as a string. The date is in 
MM/OO/YY formal 

gettime(void) return String 

This function computes the current local time and returns it as a string. The time is 
in 24 hour HWMMiSS format. 
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AD Client and Service sessions are encrypted using DES (Data Encryption Stan* 
dard) encryption. The Pages Server acfrrtnistrator is also abte to control which users 
and/or groups have access to the data sources and what land of access the user/ 
group wi have. For further information on administrating on ACL (Access Control 
List) of the data source, please refer to the chapter on Pages Server. 
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Pages Server 



To start the Pages Server 

1. Open System Command SheO (OOS shel In wfr\95, c-shell in UNIX, et cetera] 

2. Change to the insta lla ti on directory of Sango Pages. 

3. frtvoke the "Start Server* shell script byerrteririgthefoitowing: 

Start PagesServer 

4. A raw window wlfloppecrccaed^fiQges Server l>ost ^ address* This 
windows menu bar has three options: Action, Admin, and Options, the 
oniyolher features of this window is a ^ where system messages generated 
ardreceh^t^this service are dispiaved. Once you have seated Pages 
Servet the message "The Sorvor is running...* should tx) highlighted to indi 
cote that it is the most recent system message. 




r 
U 
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Action 

Starting the Server 

1. m tne "Pages Server window, select Start from me Action arooaown menu. 

2. A message will appeal in the System Messages fist: "The Server is running. . 

Stopping the Server 

1 . in the "Rages Server" window, select Stop tram the Action aropdown menu. 

2. A message wil appear in the System Messages tet: The Server is stopped". 

Starting the Web Server 

1. Select Start the Web Server from me Acflon dropdown menu. 

2. Amessagewfl appear In the System Messages fish The Webserver is runrtng..." 

Stopping the Web Server 

1. Select Stop the Web Server from the Action dropdown menu. 

2. A message wi appear in the System Messages Hst: The Web Server is 
stopped." 

Exiting Pages Server 

1. Soloct Exit from the teflon dropdown menu to shut down and exit from 
Pages Server. 

2. Close Ihe Command Prompt vwndow after Pages Saver is stopped. 
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Admin 



Login 



login is the only option avertable in the Admin drooaown menu wnen you first 
start Pages Server. Once you have toggea in property, me other options win 
become octtve. 

1 ] Select login from the Admin aropaown menu. 

2) The 'Pages Root login* window appears on the screen Enter me Pages Root 
password at the text prompt 



3) Once you have entered the password {rt v^ appear in asterisk torm), select 
OK to continue logging into the service or Cancel to return to the "Pages 
Server window without togging in. 

4) rf you selected OK and the password was validated, you wfll return to the 
"Pages Service' window, login should now have a checkmark in front of it to 
indicate that you have togged on successful* The other options of the 
•Pages Server* menubar wfiinowbeavadebte. rf there was a problem with 
the login (an invalid password perhaps), then an error message wi be dis 
played in the System Messages list and you wfll be prompted to try again. 



User Manager 



User Manager acts as an admtni»liulive tool for managing users end groups on 
the service. 

1) Select User Manager from the Admin aropdown menu. 




■ana 
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2) A new wtnaow ODDears catted "User Manager*. All the users on the service ere 
ferea by the Username. Full Name, ana the login status. All the grouos on rre 
service are aiso listed. 



3) The User dropdown menu has ftve options: Add User.... Add Group.... 
Delete. Properties, and Exit. Instructions for using each of these options 
tofoltow. 

Adding a User 

1) Select Add User... from the User dropdown menu in the User Manager 
winaow 

2) A new windowappears called *dd User Dialog'. 




3) To add another Rages user, enter the user name In the text box foflowing the 
prompt for user Name. It must be at least three characters In length and 
should not contain any spaces. 
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4) Enter me real name of tne user m me text box roiiowmg me cromcr tor Peai 
Nome. 

5) Enter me password tor the user in the text box following tne prompt tor 
Password. 

6] Select which Groups you want this user to belong to. The user must oeiorg 
to at least one group. 

7) You can also set the oate when you want the password to expire by entering 
in tne number of days m the box provioed. The numoer must be between 0 
and 90. 

6) Select OK if you want to save the information you have entered about the 
user. You will return to the "User Manager* winaow where the new user snouia 
now appear in the User list 

9] Select Cancel to return to the "User Manager" window without saving the 
entered information. 



Adding a Group 

1) Select Add Group... from the User dropdown menu in the "User Manager" 

WTOW. 

2) AnewwirKlawappecKcaM^ddLocdlGioup". 




3) Enter the new group name in the text box foiowtng the prompt tor Group 
Name. 
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A) now you con aoa to or remove Local Users from tne Group Memoers as? 

5) Select OK to save the information you have entered about me group. You wilt 
return to the *User Manager* widow wnere the new group snoutd now aooecr 
in the Group List. 

6) Select Cancel to return to the "User Manager* wmaow without saving me 
enterea information. 



Deleting Users or Groups from Pages Server 

1] tn the "User Manager* window, select the Iter or Group mat you want to 
delete from me appro p riate tet 

2) Select Delete from the User dropdown menu. 

3) A Remove Alert!!" window appw^ 
selected User/Group. 



4) SetectOK to complete Ihe deletion of the User or Group, You will return *ie 
User Manager window and you stwuWno^elhcrftheUser/Gioupisno 
longer in the appropriate tet 

5} Select Cancel to abort IheremoMOt of the User/Group from tages Servers. 
Vbu wtl retum to the *User Manager window. 



Administrating the Properties of Users 

1) Select the User you wish to workon torn the Users fet 

2) Select Properties from the User dropdown menu. 
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3) A new wmoow app ear s emitted User Properties* os iihjsrrareQ Detow 



4) As you can see in the diagram. User Nome cannot be changed. However, 
you can change the real name of the user by entering it in the text dox 
following the prompt tor Real Name. 

5) To change the password for the uset enter the new password in the text box 
following the Password prompt The password wffi. of course, appear m 
asterisk form. 

6) To change the expiration date tor the pcaswora simply enter in me new date 
in the text boxes provided The aate must be between the current date and 
December 31, 1999(99/12/31). 

7) To add or remove the user from User's Groups or System Groups, use the 
toots at the bottom or the window, dieting an a group in the list of User s 
Groups and then selecting Remove- > wi remove the selected group from 
that bst and place it in the System Groups 1st. Cfictong on a group in the Hsl 
or System Groups and then selecting Add-> wM remove the selected 
group from that fist and place it in the User's Groups Hst Reme mb e r that a 
user must belong to at least one group so the User's Groups list cannot be 
empty 

8) Select OK to save you changes. You wffl return to the TJser Manager 
whdow. 

9) Select Cancel to return to the User Manager* window without saving any 
changes. 
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Administrating the Properties of Groups 



1 ) In the "User Manager " winaow, select the Grouo whose Prooerties vou wisn to 
view 

21 Select Properties from the User aropaown menu. 

3) A new wtndow appears entitled local Group Properties" (as iJtustrarea oetowi 



4 ) As vou can see in the diagram, this window allows vou to add ana remove 
Local Users to the Group where they became Group Members. CSckrg 
on a gioup in the list of Groups Members cmd then selecting ftemove~> 
win remove the selected group from that fist and place It in the Loccti Users 
list Clicking on a group in the 1st of local Users and then selecting Add- > 
wfli rewnove the selected group from that 1st and place it in the Groups 
Members Dst 

5) Select OK to save the changes that you hove made and to return 
User Manager window. 

6) Select Cancel to return to the "User Manager window without saving any 
changes you have made. 



Exiting the "User Manager" window 

Select Exit from the User dropdown menu to dose the Iter Manager" window 
and return to the "Pages Service* window 
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Data Source ACL Manager 

The Data Source ACL Manager provides a way to attacn an Access Conm list 
(ACL) to the aata sources proviaea Ovthe service These lists are usea to ensure 
me security of the aata sources ana to provtae access only to authonzea users 
To use the Data Source ACL Manager, select Data Source ACL Manager rrorn 
me Admin aropaown menu The "Data Source ACL Manager* wmaow aDDears. 
disproving a tot of configured aata sources and various actions mat can oe 
performed (Add. Delete, Setup, and OK). 




Data Source List: This is a list of data sources tor which an ACL has previously 
been configured. Selecting an item in mis 1st wfflattcw you to either Deteteor 
Setup the data source ACL Both of these options are described below. 



Adding a Data Source ACL 

1. SetecttaeAdd button in the "Data Source ACL Manager* window. 

2. A new window appears called *Add Data Source ACL". This wmaow displays a 
list of aO the data sources provided by the service. 




3. Select the data source for which you want to add an ACL and cfick OK, or 

4. Select Cmcel to return to the "Data Source ACL Manager" window without 
creating a new ACL. 
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5. it vou selected OK in sreo 3 . men me *Dato Source ACL Setuo" wmaow witi 
appear so you con start conftgimng a now ACL for me acta source. Ptease 
refer to the section on Setting Up a Data Source ACL for information on ma 
window. 



Deleting Data Sources from the ACL 

1 . Select me data source from the list displayed in the Data Source ACL 
Manager" wrnaaw. 

2. Click on the Delete button. 

3. A "Remove Alertir window will appear to warning you mat you are about to 
remove the data source ACL. 




4. Ctk^ OK to continue wim the deiefcn and to return 

Manager window where you wffl notice the data source is no longer present 
in the list 

5. CSck Cancel to stop the deletion process. Ybuwfflretifln to the "Data Source 
ACL Manager window. 



Setting Up a Data Source ACL 



The configuration of a data source ACL is nxjnoged by the T)ata Source ACL 
Setup* window. This window can be entered by etthet 

A) Adding a new data source and then setting the inflld configuration (described 
in me previous section). tntWscasemebianfcACLwIbeesrabishedwrmno 
permissions set 
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8) Select a oata source from tne test n me *Data Source ACL Monager wmcow 
ana dieting on the Setup button, when entering ma way me ACl's orevtous 
vatues will be loaded. 



The above iustration displays the Data Source ACL Setup window which contains 
the following areas: 

1. The Name of the Oata Source is displayed at the top. This value cannot be 
changed as it must match the actual data source value. 

2. Below this are two list* o Users Bst and a Groups list. The Users list contains 
all local users managed by this service. The Groups list contains the aetouit 
system wide groups as wel as any tocxity defined groups. 

3. Next to these ists are the Pages Permissions which are made up of the 

tallowing set: 

• Control -for the creator of the data source. 

• Read - aUows readonly access to the data source, 

• Update - aflows the user/group to update any changes made to the 
data source, 

• Execute * allow the uset/group to execute a fUe outside of Sango Pages, 

• lest for Ex i stenc e - det e rmine s whether or not the user has access to 
see data source, 

• Delete - alows the User/Group access to delete a data source, and 

• Create -alow the User/Group access to create a data source. 
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Whenever o user or grouo is selected these cnecit Doxes will reflect the permis- 
sion set format user/group. To aad (box contains a*') or remove (box c emoty) c 
permasion stmpty click on the appiopnate field ana the value will be toggtea. 

4. Select OK to save tne ACL ana return to me Data Source ACL Manager" 
wtnaow. ir this was a new aata source ACL bemg created then the aata 
source should now appear m the fist of data sources. 

5. Select Cancel to ignore ail changes to the data source ACL ana return to 
the Data Source ACL Manager window, if this was a previously existing aata 
source ACL then the origrot ACL will still be intact If this was a new ACL then 
all entered aata will be lost and no ACL wi be created for the aata source. 



Exiting the "Data Source ACL Manager" window. 

Selecting the OKbutton wi close the •Data Source ACL Manager* window ana 
return you to the mam "Pages Service' window. 



The third option available In the "Pages Server window is Options which has three 
additional toots tor the Pages Server cdmintstratot 



Show Services 



In the "Rages Server window, select Show Services from the Options dropdown 
menu. 

A new wtksow appears cafled^vc^oble Services*. A 1st of of the Pages Servers 
avaiabie on your intranet is displayed. 



Options 
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Click OK to return to the "Pages Server* wmaow. 



Current Users 

1) in me "Pages Server winaow. select Current Users from the Options 
aropaownmenu. 

2) A new wnaow appears called "Current Users*. A list of all the users currently 
toggea on the server osb aisptayed. 




3) C8ck OK to return to the "Pages Server* window. 



Broadcast Message 

The Broadcast Message tool is useful for Informing tfher users on me Server adout 
any changes happening on the Service fl.e.^ server wfl be stopped in five 
mrtuteO or perhaps anysocW events happe 
at the FireSation Friday night at 8 p.m.1. 

1) In the Pages Server window, select Broadcast Message from ihe Options 
dropdown menu. 

2) AnewwMowappeaRcaled"Broodcas!M 
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3) Enter the message you wish to send in the text box following the Message 
prompt 

4) Cfick OK to send the message and to return to the Toges Services' winaow, or 

5) Click Cancel to exit the window without sending a message. *bu will return 
to the "Pages Services winaow". 
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The foregoing discussion discloses and describes merely exemplary 
methods and embodiments of the present invention. As will be understood 
by those familiar with the art, the invention may be embodied in other 
specific forms without departing from the spirit or essential characteristics 
thereof. Accordingly, the disclosure of the present invention is intended to be 
illustrative, but not limiting, of the scope of the invention, which is set forth 
in the following claims. 
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1. A system for accessing data stored in a plurality of storage mediums and in 
a plurality of storage formats, comprising: 

a client module having browserware application properties and 
providing a desktop having a plurality of books each associated with data 
stored in a storage medium; and 

a server module operatively coupled to the client module, the server 
module including computer instructions for performing the method 
comprising: 

storing information associating the book with metadata for 
retrieving the data associated with the book; 

receiving an access request identifying a data source from the 
client module; 

retrieving metadata corresponding to the data source; 

retrieving data corresponding to the metadata; and 

sending the retrieved data to the client module. 

2. The system of claim 1 wherein the client module runs in a browser 
environment. 

3. The system of claim 1 wherein the client module is a platform 
independent module. 

4. The system of claim 1 further comprising a scripting module having a byte- 
code generator disposed to generate byte-code from a form layout. 
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5. The system of claim 1 wherein the storage medium arranges data in a row 
and column format and wherein the book comprises: 

a data source identifier; 

a plurality of attributes each identifying a column; 
a join condition; and 
view information. 

6. The system of claim 5 further comprising a result object for returning the 
result of a data source query generated from the data source identifier, the 
plurality of table identifiers and the join condition. 

7. The system of claim 6 wherein the result object is presented in accordance 
with the view information. 

8. The system of claim 5 wherein the view information includes a selection 
of data attributes and a search condition. 

9. The system of claim 5 wherein the view information further includes a 
plurality of forms. 

10. A computer implemented method for accessing data stored in a plurality 
of storage mediums and in a plurality of storage formats, comprising: 

providing a client module having browserware application properties 
and having a desktop having a book identifying data stored in a storage 
medium; 
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providing a server module storing information associating the books 
with metadata for retrieving the data identified by the book; 

receiving at the server module a data access request from the client 
module; 

retrieving metadata responsive to the access request; and 
retrieving data stored in accordance with the metadata; 
sending the retrieved data from the server module to the client 
module, 

11. The method of claim 10 wherein the client module runs in a browser 
environment. 

12. The method of claim 10 wherein the client module is a platform 
independent module. 

13. The method of claim 10 further comprising: 

providing a form layout interface having user customizable data 
display attributes; 

processing the customized form to generate byte-code disposed to 
display retrieved data in accordance with the customized form. 

14. The method of claim 10 further comprising: 

providing a user interface for identifying a data source- 
determining the physical storage information associated with the 

identified data source; 

generating metadata from the determined physical storage 

information; and 
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storing the metadata. 

15. The method of claim 14 wherein the identified data source identifies data 
stored in first and second tables in a database and includes a table join 
condition. 

16. The method of claim 14 wherein the identified data source is an electronic 
mail system. 
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